Inside Macintosh: AppleScript Scripting Additions Guide /

Chapter 3 - Writing Scripting Additions

The Scripting Addition Size Resource

If your scripting addition doesn't include any owned resources, you can improve its performance by providing a scripting addition size resource. A scripting addition size resource is a resource of type 'osiz' that allows you to specify whether your scripting addition has any owned resources and whether to limit the events it can receive to events sent from the local computer.

An 'osiz' resource must have resource ID 0. Listing 3-1 shows the resource type declaration in Rez format for the 'osiz' resource.

Listing 3-1 Resource type declaration for the 'osiz' resource

type 'osiz' {
      boolean  openResourceFile, 
               dontOpenResourceFile;
      boolean  acceptRemoteEvents,
               dontAcceptRemoteEvents;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
      boolean  reserved;
};

The data for an 'osiz' resource consists of flags that specify Boolean values:

• The first flag specifies whether AppleScript should (openResourceFile) or should not (dontOpenResourceFile) open the scripting addition's resource fork each time one of its commands is invoked from a script. You should set this flag to dontOpenResourceFileif your scripting addition doesn't include any owned resources.
• The second flag specifies whether the scripting addition accepts (acceptRemoteEvents) or doesn't accept (dontAcceptRemoteEvents) events sent to it from a remote computer. If you don't want users of remote computers to be able to use your scripting addition, set this flag to dontAcceptRemoteEvents. This might be desirable, for example, if you don't want users of remote computers to use the scripting addition to modify data on the local machine or if the scripting addition requires interaction with the user.
• The following 30 bits are reserved for future use. Their values must be set to reserved.